<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>返回指定日期/时间的详细信息的关联数组</title>
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-base.css" />
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-medium.css" />

 </head>
 <body class="docs"><div class="navbar navbar-fixed-top">
  <div class="navbar-inner clearfix">
    <ul class="nav" style="width: 100%">
      <li style="float: left;"><a href="function.date-parse-from-format.html">« date_parse_from_format</a></li>
      <li style="float: right;"><a href="function.date-sub.html">date_sub »</a></li>
    </ul>
  </div>
</div>
<div id="breadcrumbs" class="clearfix">
  <ul class="breadcrumbs-container">
    <li><a href="index.html">PHP Manual</a></li>
    <li><a href="ref.datetime.html">Date/Time 函数</a></li>
    <li>返回指定日期/时间的详细信息的关联数组</li>
  </ul>
</div>
<div id="layout">
  <div id="layout-content"><div id="function.date-parse" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">date_parse</h1>
  <p class="verinfo">(PHP 5 &gt;= 5.2.0, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">date_parse</span> &mdash; <span class="dc-title">返回指定日期/时间的详细信息的关联数组</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.date-parse-description">
  <h3 class="title">说明</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>date_parse</strong></span>(<span class="methodparam"><span class="type">string</span> <code class="parameter">$datetime</code></span>): <span class="type">array</span></div>

  <p class="para rdfs-comment">
   <span class="function"><strong>date_parse()</strong></span> 根据与 <span class="function"><a href="function.strtotime.html" class="function">strtotime()</a></span>
   和 <span class="function"><a href="datetimeimmutable.construct.html" class="function">DateTimeImmutable::__construct()</a></span> 相同的规则解析指定
   <code class="parameter">datetime</code> 字符串。它不返回 Unix 时间戳（使用
   <span class="function"><a href="function.strtotime.html" class="function">strtotime()</a></span>）或者 <span class="classname"><a href="class.datetimeimmutable.html" class="classname">DateTimeImmutable</a></span>
   对象（使用 <span class="function"><a href="datetimeimmutable.construct.html" class="function">DateTimeImmutable::__construct()</a></span>），而是返回包含在指定
   <code class="parameter">datetime</code> 字符串中检测到相关信息的关联数组。
  </p>
  <p class="para">
   如果找不到某组元素的信息，那么这些数组元素将会设置为 <strong><code>false</code></strong> 或缺失。如果需要从相同的
   <code class="parameter">datetime</code> 字符串构建时间戳或者 <span class="classname"><a href="class.datetimeimmutable.html" class="classname">DateTimeImmutable</a></span>
   对象，需要将更多字段设置为非 <strong><code>false</code></strong> 值。查看以下示例以了解情况。
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.date-parse-parameters">
  <h3 class="title">参数</h3>
  <p class="para">
   <dl>
    
     <dt>
<code class="parameter">datetime</code></dt>

     <dd>

      <p class="para">
       <span class="function"><a href="datetimeimmutable.construct.html" class="function">DateTimeImmutable::__construct()</a></span> 接受的日期/时间格式。
      </p>
     </dd>

    
   </dl>

  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.date-parse-returnvalues">
  <h3 class="title">返回值</h3>
  <p class="para">
   成功时返回 <span class="type">array</span>，数组中包含解析日期/时间的信息。 或者在失败时返回 <strong><code>false</code></strong>。
  </p>
  <p class="para">
   返回的数组存在以下键 
   <code class="literal">year</code>、<code class="literal">month</code>、<code class="literal">day</code>、<code class="literal">hour</code>、<code class="literal">minute</code>、<code class="literal">second</code>、<code class="literal">fraction</code>
   和 <code class="literal">is_localtime</code>。
  </p>
  <p class="para">
   如果存在 <code class="literal">is_localtime</code>，则 <code class="literal">zone_type</code> 表示时区类型。类型
   <code class="literal">1</code>（UTC 时差），添加 <code class="literal">zone</code>、<code class="literal">is_dst</code>；类型
   <code class="literal">2</code>（时区缩写），添加 <code class="literal">tz_abbr</code>、<code class="literal">is_dst</code>；类型
   <code class="literal">3</code>（时区标识符），添加 <code class="literal">tz_abbr</code>、<code class="literal">tz_id</code>。
  </p>
  <p class="para">
   如果 <code class="parameter">datetime</code> 字符串存在类似 <code class="literal">+3 days</code>
   这样的相对时间元素，则返回的数组则包含键为 <code class="literal">relative</code> 的嵌套数组。然后此数组将包含如下键
   <code class="literal">year</code>、<code class="literal">month</code>、<code class="literal">day</code>、<code class="literal">hour</code>、<code class="literal">minute</code>、<code class="literal">second</code>，如果必要还会包含
   <code class="literal">weekday</code> 和 <code class="literal">weekdays</code>，具体取决于传入的字符串。
  </p>
  <p class="para">
   数组包含 <code class="literal">warning_count</code> 和 <code class="literal">warnings</code>
   字段。第一个表示发现了多少警告。元素 <code class="literal">warnings</code> 的键表示指定
   <code class="parameter">datetime</code> 发生警告的位置，值为字符串，描述警告本身。
  </p>
  <p class="para">
   数组也包含 <code class="literal">error_count</code> 和 <code class="literal">errors</code>
   字段。第一个表示发现了多少错误。元素 <code class="literal">errors</code> 的键表示指定
   <code class="parameter">datetime</code> 发生错误的位置，值为字符串，描述错误本身。
  </p>
  <div class="warning"><strong class="warning">警告</strong>
   <p class="para">
    如果同一个位置存在多个警告/错误，那么 <code class="literal">warnings</code> 和 <code class="literal">errors</code>
    数组中元素的数量可能会少于 <code class="literal">warning_count</code> 或者 <code class="literal">error_count</code>。
   </p>
  </div>
 </div>


 <div class="refsect1 errors" id="refsect1-function.date-parse-errors">
  <h3 class="title">错误／异常</h3>
  <p class="para">
   date/time 的格式有错误时，返回数组的 &#039;errors&#039; 键将包含错误信息。
  </p>
 </div>

 
 <div class="refsect1 changelog" id="refsect1-function.date-parse-changelog">
  <h3 class="title">更新日志</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>版本</th>
      <th>说明</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>7.2.0</td>
      <td>
       返回数组的 <code class="literal">zone</code> 
       键现在代表秒，而不是分钟。并且正负符号已反转，例如：之前是
       <code class="literal">-120</code> 现在是 <code class="literal">7200</code>。
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 examples" id="refsect1-function.date-parse-examples">
  <h3 class="title">范例</h3>
  <p class="para">
   <div class="example" id="example-2076">
    <p><strong>示例 #1 具有全面的 <code class="parameter">datetime</code> 字符串的 <span class="function"><strong>date_parse()</strong></span> 示例</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">date_parse</span><span style="color: #007700">(</span><span style="color: #DD0000">"2006-12-12&nbsp;10:00:00.5"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

    <div class="example-contents"><p>以上例程会输出：</p></div>
    <div class="example-contents screen">
<div class="cdata"><pre>
array(12) {
  [&quot;year&quot;]=&gt;
  int(2006)
  [&quot;month&quot;]=&gt;
  int(12)
  [&quot;day&quot;]=&gt;
  int(12)
  [&quot;hour&quot;]=&gt;
  int(10)
  [&quot;minute&quot;]=&gt;
  int(0)
  [&quot;second&quot;]=&gt;
  int(0)
  [&quot;fraction&quot;]=&gt;
  float(0.5)
  [&quot;warning_count&quot;]=&gt;
  int(0)
  [&quot;warnings&quot;]=&gt;
  array(0) {
  }
  [&quot;error_count&quot;]=&gt;
  int(0)
  [&quot;errors&quot;]=&gt;
  array(0) {
  }
  [&quot;is_localtime&quot;]=&gt;
  bool(false)
}
</pre></div>
    </div>
   </div>
  </p>

  <p class="para">
   如果在指定 <code class="parameter">datetime</code>
   字符串中出现时区元素，那才会展示。在这种情况下，总会存在
   <code class="literal">zone_type</code> 和更多元素，具体取决于其值。
   <div class="example" id="example-2077">
    <p><strong>示例 #2 带时区缩写信息的 <span class="function"><strong>date_parse()</strong></span></strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">date_parse</span><span style="color: #007700">(</span><span style="color: #DD0000">"June&nbsp;2nd,&nbsp;2022,&nbsp;10:28:17&nbsp;BST"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

    <div class="example-contents"><p>以上例程会输出：</p></div>
    <div class="example-contents screen">
<div class="cdata"><pre>
array(16) {
  [&quot;year&quot;]=&gt;
  int(2022)
  [&quot;month&quot;]=&gt;
  int(6)
  [&quot;day&quot;]=&gt;
  int(2)
  [&quot;hour&quot;]=&gt;
  int(10)
  [&quot;minute&quot;]=&gt;
  int(28)
  [&quot;second&quot;]=&gt;
  int(17)
  [&quot;fraction&quot;]=&gt;
  float(0)
  [&quot;warning_count&quot;]=&gt;
  int(0)
  [&quot;warnings&quot;]=&gt;
  array(0) {
  }
  [&quot;error_count&quot;]=&gt;
  int(0)
  [&quot;errors&quot;]=&gt;
  array(0) {
  }
  [&quot;is_localtime&quot;]=&gt;
  bool(true)
  [&quot;zone_type&quot;]=&gt;
  int(2)
  [&quot;zone&quot;]=&gt;
  int(0)
  [&quot;is_dst&quot;]=&gt;
  bool(true)
  [&quot;tz_abbr&quot;]=&gt;
  string(3) &quot;BST&quot;
}
</pre></div>
    </div>
   </div>
   <div class="example" id="example-2078">
    <p><strong>示例 #3 带时区标识符信息的 <span class="function"><strong>date_parse()</strong></span></strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">date_parse</span><span style="color: #007700">(</span><span style="color: #DD0000">"June&nbsp;2nd,&nbsp;2022,&nbsp;10:28:17&nbsp;Europe/London"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

    <div class="example-contents"><p>以上例程会输出：</p></div>
    <div class="example-contents screen">
<div class="cdata"><pre>
array(14) {
  [&quot;year&quot;]=&gt;
  int(2022)
  [&quot;month&quot;]=&gt;
  int(6)
  [&quot;day&quot;]=&gt;
  int(2)
  [&quot;hour&quot;]=&gt;
  int(10)
  [&quot;minute&quot;]=&gt;
  int(28)
  [&quot;second&quot;]=&gt;
  int(17)
  [&quot;fraction&quot;]=&gt;
  float(0)
  [&quot;warning_count&quot;]=&gt;
  int(0)
  [&quot;warnings&quot;]=&gt;
  array(0) {
  }
  [&quot;error_count&quot;]=&gt;
  int(0)
  [&quot;errors&quot;]=&gt;
  array(0) {
  }
  [&quot;is_localtime&quot;]=&gt;
  bool(true)
  [&quot;zone_type&quot;]=&gt;
  int(3)
  [&quot;tz_id&quot;]=&gt;
  string(13) &quot;Europe/London&quot;
}
</pre></div>
    </div>
   </div>
  </p>

  <p class="para">
   如果解析的 <code class="parameter">datetime</code> 字符串越小，那么可用的信息就越少。再本示例中，所有时间部分都返回为 <strong><code>false</code></strong>。
   <div class="example" id="example-2079">
    <p><strong>示例 #4 带最小字符串的 <span class="function"><strong>date_parse()</strong></span></strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">date_parse</span><span style="color: #007700">(</span><span style="color: #DD0000">"June&nbsp;2nd,&nbsp;2022"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

    <div class="example-contents"><p>以上例程会输出：</p></div>
    <div class="example-contents screen">
<div class="cdata"><pre>
array(12) {
  [&quot;year&quot;]=&gt;
  int(2022)
  [&quot;month&quot;]=&gt;
  int(6)
  [&quot;day&quot;]=&gt;
  int(2)
  [&quot;hour&quot;]=&gt;
  bool(false)
  [&quot;minute&quot;]=&gt;
  bool(false)
  [&quot;second&quot;]=&gt;
  bool(false)
  [&quot;fraction&quot;]=&gt;
  bool(false)
  [&quot;warning_count&quot;]=&gt;
  int(0)
  [&quot;warnings&quot;]=&gt;
  array(0) {
  }
  [&quot;error_count&quot;]=&gt;
  int(0)
  [&quot;errors&quot;]=&gt;
  array(0) {
  }
  [&quot;is_localtime&quot;]=&gt;
  bool(false)
}
</pre></div>
    </div>
   </div>
  </p>

  <p class="para">
   <a href="datetime.formats.relative.html" class="link">相对格式</a>不会影响从绝对格式格式化的值，但会被解析为“relative”元素。
   <div class="example" id="example-2080">
    <p><strong>示例 #5 带相对格式的 <span class="function"><strong>date_parse()</strong></span></strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">date_parse</span><span style="color: #007700">(</span><span style="color: #DD0000">"2006-12-12&nbsp;10:00:00.5&nbsp;+1&nbsp;week&nbsp;+1&nbsp;hour"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

    <div class="example-contents"><p>以上例程会输出：</p></div>
    <div class="example-contents screen">
<div class="cdata"><pre>
array(13) {
  [&quot;year&quot;]=&gt;
  int(2006)
  [&quot;month&quot;]=&gt;
  int(12)
  [&quot;day&quot;]=&gt;
  int(12)
  [&quot;hour&quot;]=&gt;
  int(10)
  [&quot;minute&quot;]=&gt;
  int(0)
  [&quot;second&quot;]=&gt;
  int(0)
  [&quot;fraction&quot;]=&gt;
  float(0.5)
  [&quot;warning_count&quot;]=&gt;
  int(0)
  [&quot;warnings&quot;]=&gt;
  array(0) {
  }
  [&quot;error_count&quot;]=&gt;
  int(0)
  [&quot;errors&quot;]=&gt;
  array(0) {
  }
  [&quot;is_localtime&quot;]=&gt;
  bool(false)
  [&quot;relative&quot;]=&gt;
  array(6) {
    [&quot;year&quot;]=&gt;
    int(0)
    [&quot;month&quot;]=&gt;
    int(0)
    [&quot;day&quot;]=&gt;
    int(7)
    [&quot;hour&quot;]=&gt;
    int(1)
    [&quot;minute&quot;]=&gt;
    int(0)
    [&quot;second&quot;]=&gt;
    int(0)
  }
}
</pre></div>
    </div>
   </div>
  </p>

  <p class="para">
   在某些时候，比如 <code class="literal">Thursday</code> 将会设置字符串的时间部分设置为
   <code class="literal">0</code>。如果 <code class="literal">Thursday</code> 传递给
   <span class="function"><a href="datetimeimmutable.construct.html" class="function">DateTimeImmutable::__construct()</a></span> 也会导致小时，分钟，秒和小数部分设置为
   <code class="literal">0</code>。下面的示例中，year 元素将设置为 <strong><code>false</code></strong>。
   <div class="example" id="example-2081">
    <p><strong>示例 #6 <span class="function"><strong>date_parse()</strong></span> with side-effects</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">date_parse</span><span style="color: #007700">(</span><span style="color: #DD0000">"Thursday,&nbsp;June&nbsp;2nd"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

    <div class="example-contents"><p>以上例程会输出：</p></div>
    <div class="example-contents screen">
<div class="cdata"><pre>
array(13) {
  [&quot;year&quot;]=&gt;
  bool(false)
  [&quot;month&quot;]=&gt;
  int(6)
  [&quot;day&quot;]=&gt;
  int(2)
  [&quot;hour&quot;]=&gt;
  int(0)
  [&quot;minute&quot;]=&gt;
  int(0)
  [&quot;second&quot;]=&gt;
  int(0)
  [&quot;fraction&quot;]=&gt;
  float(0)
  [&quot;warning_count&quot;]=&gt;
  int(0)
  [&quot;warnings&quot;]=&gt;
  array(0) {
  }
  [&quot;error_count&quot;]=&gt;
  int(0)
  [&quot;errors&quot;]=&gt;
  array(0) {
  }
  [&quot;is_localtime&quot;]=&gt;
  bool(false)
  [&quot;relative&quot;]=&gt;
  array(7) {
    [&quot;year&quot;]=&gt;
    int(0)
    [&quot;month&quot;]=&gt;
    int(0)
    [&quot;day&quot;]=&gt;
    int(0)
    [&quot;hour&quot;]=&gt;
    int(0)
    [&quot;minute&quot;]=&gt;
    int(0)
    [&quot;second&quot;]=&gt;
    int(0)
    [&quot;weekday&quot;]=&gt;
    int(4)
  }
}
</pre></div>
    </div>
   </div>
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.date-parse-seealso">
  <h3 class="title">参见</h3>
  <p class="para">
   <ul class="simplelist">
    <li class="member"><span class="function"><a href="function.date-parse-from-format.html" class="function" rel="rdfs-seeAlso">date_parse_from_format()</a> - Get info about given date formatted according to the specified format</span>，以解析具有特定格式的<code class="parameter">datetime</code></li>
    <li class="member"><span class="function"><a href="function.checkdate.html" class="function" rel="rdfs-seeAlso">checkdate()</a> - 验证一个格里高里日期</span>，以便于公历日期验证</li>
    <li class="member"><span class="function"><a href="function.getdate.html" class="function" rel="rdfs-seeAlso">getdate()</a> - 获取日期/时间信息</span></li>
   </ul>
  </p>
 </div>


</div></div></div></body></html>